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LICENSE AND WARRANTY AGREEMENT 



READ THIS AGREEMENT CAREFULLY. USE OF 
THIS PRODUCT CONSTITUTES YOUR ACCEP- 
TANCE OF THE TERMS AND CONDITIONS OF 
THIS AGREEMENT. 

LIMITED WARRANTY 

This Software program is licensed on an "AS IS" 
basis, without warranty. The original CUSTOMER'S 
exclusive remedy, in the event of 3 manufacturing 
defect in the diskette, is its repair or replacement 
within thirty (30) calendar days of the date of the 
Radio Shack sales document received upon the li- 
cense of the Software. The defective diskette shall 
be returned to a Radio Shack Computer Center, a 
Radio Shack retail store, participating Radio Shack 
franchisee or Radio Shack dealer along with the 
sales document. 

EXCEPT AS PROVIDED HEREIN, RADIO SHACK 
AND SOFTWARE ARTS, INC. MAKE NO EX- 
PRESS WARRANTIES, AND ANY IMPLIED WAR- 
RANT Y OF MERCHANTAB I LIT Y OR FITNESS FOR 
A PARTICULAR PURPOSE IS LIMITED IN ITS DU- 
RATION TO THE DURATION OF THE WRITTEN 
LIMITED WARRANTIES SET FORTH HEREIN. 

Some states do not allow limitations on how long an 
impiied warranty lasts, so the above limitation^} 
may not apply to CUSTOMER. 

DISCLAIMER OF LIABILITY 

RADIO SHACK AND SOFTWARE ARTS, INC. 
SHALL HAVE NO LIABILITYOR RESPONSIBILITY 
TO CUSTOMER OR ANYOTHER PERSON OR EN- 
TITY WITH RESPECT TO ANY LIABILITY, LOSS 
OR DAMAGE CAUSED OR ALLEGED TO BE 
CAUSED DIRECTLY OR INDIRECTLY BY "SOFT- 
WARE" LICENSED OR FURNISHED BY RADIO 
SHACK AND/OR SOFTWARE ARTS, INC., IN- 
CLUDING, BUT NOT LIMITED TO, ANY INTER- 
RUPTION OF SERVICE, LOSS OF BUSINESS OR 
ANTICIPATORY PROFITS OR INDIRECT, SPECIAL 
OR CONSEQUENTIAL DAMAGES. 

Some states do not allow the limitation or exclusion 
of consequential damages, so the above lim- 
itation(s) or exclusion(s) may not apply to 
CUSTOMER. 



SOFTWARE LICENSE 

RADIO SHACK and SOFTWARE ARTS, INC. grant 
to CUSTOMER a non-exclusive, paid-up license to 
use this Software on one computer subject to the 
following provisions: 

A. Except as otherwise provided in this Software 
License, applicable copyright laws shall apply to the 
Software. 

B. Title to the medium on which the Software is re- 
corded idiskette) is transferred to CUSTOMER, but 
not title to the Software. 

C. CUSTOMER shall not use, make, manufacture 
or reproduce copies of the Software except for use 
on one computer and except as is specifically pro- 
vided in this Software License. CUSTOMER is ex- 
pressly prohibited from disassembling the 
Software. 

D. CUSTOMER is permitted to make six additional 
copies of the Software only for back-up or archival 
purposes or if such additional copies are required in 
the operation of one computer with the Software, 
but only to the extent the Software documentation 
allows back-up copies to be made. 

E. All copyright notices shall be retained on all 
copies of the Software. 

F. CUSTOMER is permitted to transfer unmodified 
Software and all copies of the Software which have 
been made to a single third party provided CUS- 
TOMER has paid for the Software to be transferred. 
In any event the provisions of this License and War- 
ranty Agreement shall be applicable to a third party 
receiving the Software from CUSTOMER. 

THIS LICENSE AND WARRANTY AGREEMENT 
CONSTITUTES THE ENTIRE AGREEMENT AND 
UNDERSTANDING BETWEEN THE PARTIES AND 
SUPERSEDES ANY PROPOSAL OR PRIOR 
AGREEMENT, ORAL OR WRITTEN, AND ANY 
OTHER COMMUNICATION RELATING TO THE 
SUBJECT MATTER OF THIS AGREEMENT. 

The warranties granted herein give the original 
CUSTOMER specific legal rights, and the original 
CUSTOMER may have other rights which vary from 
state to state. 
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introduction 

This Introductory Guide will help you to begin using the 
TK! Solver® program immediately. It provides a quick overview 
of the program and introduces you to some of the program's 
commands and features. 

The Guide does not provide explanations or descriptions of the 
commands and features of the program or of what you will see on 
the screen. For a detailed explanation of the program, see the 
TKlSolver Instruction Manual and Reference Manual. 

To produce the results illustrated in the figures, you should fol- 
low the directions in this Guide. The program does not distin- 
guish between uppercase and lowercase characters for program 
commands and filenames. 

What you type is printed in blue in the text. 

The TKlSolver Program 

The TKlSolver program makes it easy to solve mathematical 
problems. You simply enter one or more equations and then tell 
the program to solve them. All the tools needed for problem 
solving are built into the program, including mathematical func- 
tions, facilities for converting units of measurement, and the 
ability to produce graphs and tables. 

The TKlSolver program can solve a broad range of problems us- 
ing models, sets of equations with variables of known and un- 
known values. Given a model and the values of the variables, the 
TKlSolver program solves for as many unknown values as is pos- 
sible. The program's problem-solving ability is powerful and ver- 
satile enough to apply to many fields, from financial planning to 
architectural design to chemical analysis. 

Required Equipment 

To use the TKlSolver program, you need: 

Hardware 

• The Radio Shack® TRS-80® Model 4 computer with at least 
128K bytes of memory and one or more disk drives. A hard 



TKISolver Program 



disk is optional. Hard disks must be formatted with TRS- 
DOS®. Refer to the TRS-80 Model 4 Hard Disk Start-Up Man- 
ual for more information. 

• Blank, formatted storage diskettes. See the TRS-80 Model 4 
Disk System Owner's Manual or Chapter 2 of the TKISolver 
Instruction Manual for information on formatting diskettes. 

• A Radio Shack parallel printer (optional). 

Software 

• The TKISolver program diskette. The program diskette con- 
tains all the TRSDOS files needed to boot the system. 



Getting Started 

Before you begin, you must make a backup copy of your 
TKISolver diskette. Formatting and backup instructions are 
found in Chapter 2 of the Instruction Manual. Keep the original 
TKISolver diskette in a safe place as a master. 

To use this Guide, you need the backup copy of your TKISolver 
program diskette and your Radio Shack TRS-80 Model 4. Even if 
you have stored TRSDOS on a hard disk, please load TRSDOS 
using the TKISolver program diskette, as directed below. 

Turn on your computer. The 
ON/OFF switch is in the front 
on the right, under the key- 
board. Insert the TKISolver 
program diskette into the disk 
drive so that the oval cutout 
enters first and the label enters 
last, as illustrated in Figure 1 . 
If you have a two-drive system, 
insert the diskette into the 
lower drive (drive 0). Figure 1 




f 
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Close the latch as illustrated in 
Figure 2. 

After you have inserted the 
program diskette, press the re- 
cessed button on the right of 
the keyboard, called the RE- 
SET button. 

When the disk drive light has 

gone out, respond to any 

prompts displayed by TRS- Figure 2 

DOS. If you make a mistake while typing, use the left arrow key 

to erase your error. 

Computers distinguish between numerals and letters, so be sure 
to use the numeral 1 to represent the number 1 . 

When you see the TRSDOS system prompt TRSDOS Ready, you 
are ready to load the TKISolver program. To enter information 
or complete a command in the TKISolver program, use the Enter 
key. In the text, this key is represented by the symbol ♦ . When 
you see ♦ , press this key. 

To load the TKISolver program, type: 



When your screen looks like Figure 3, the TKISolver program has 
begun loading. 

On the screen is the TK I Solver copyright notice and version num- 
ber. The version number may be different on your program. 

There is a message at the bottom of the screen: 

Press ENTER to Start 

Press # . 

At the top of the screen is the message: 

Loading the TKISolver program 
Copyright (c) 1984 Software Arts, Inc. 
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Figure 3 



'or Help, type 7 

:r.^--- = = = ^^ = ^z = = = = = = VARIABLE iHEtT = = = = = = = = = = = = : 

■t Input Name Output Unit Comment 



RULE SHEET 



Ru le 



f" 



Figure 4 
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When the program has finished loading, the screen should look 
like Figure 4. The TK! Solver program is now ready to be used. 
Leave the TK! Solver diskette in the drive while you are using this 
Guide. 

Correcting Mistakes 
If you make a typing mistake 
while you are in the TK! Solver 
program, erase it using the key 
marked F2. This key is located 
at the top of the numeric key- 
pad on the right side of the key- 
board. In this text, the F2 key 
is referred to as the Backspace 

key and is represented by the symbol <, When you see <4, press 
this key. 

The Backspace key erases one character at a time. For example, 
type: 



N 


( ^ 

[F2J 


r ~\ 

F3 

V. J 


r ^ r >\ r > 

7 8 9 

l J L J V J 



Do not press ♦ . 
line. 



Now press < . The character e is erased from the 



To break out of or cancel an entry or command in the TK! Solver 
program, press the Break key. The Break key is on the upper right 
side of the keyboard and is marked BREAK. It is represented in 
this text by the symbol ®. When you see <g>, press this key. 

The abed should still be on your screen. Cancel this entry by 
pressing x . The characters are gone and the screen looks the 
same as it was before, but without the Help prompt. 

Quitting the Program 

Quitting the TK!Solver program clears the TK!Solver display 

from the screen. 



Quit by typing: 
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To return to the program, type: 

TK ♦ 

Again, you should see the TK!Solver copyright screen (Figure 3). 
Press ♦ to continue loading the program. 

Working with the TKiSolver Program 

Many features of the TKiSolver program are named with famil- 
iar words. For example, in the TKiSolver program you enter in- 
formation on a variety of forms displayed on the screen, just as 
you would write down information on sheets of paper. These 
forms are called sheets. The equations, variables, values, com- 
ments, and other information contained on the TKiSolver sheets 
constitute what is referred to as a model in the text. 

The TKiSolver program can display either one or two sheets at a 
time. The sections of the screen showing the sheets are called win- 
dows, because you look 'through them to see the sheets. 

Your screen now shows two sheets in two windows: the Variable 
Sheet is in the top window; the Rule Sheet is in the bottom win- 
dow. 

Moving Around 

Each of the spaces on a TKiSolver sheet that can hold informa- 
tion is called a field. Before you can use the program, you need to 
know how to move the cursor around the sheet from field to field 
and between the windows. The TKiSolver cursor is the rectangu- 
lar highlight that marks your position on the screen. Your cursor 
should be at the top of the Rule Sheet in the first field of the col- 
umn labeled Rule. 

The semicolon (;) switches the cursor between windows. Within a 
window, the cursor is moved with the Arrow keys. 

The Arrow keys are located on either side of the top row of alpha- 
betic keys. Each Arrow key moves the cursor in the direction indi- 
cated by the arrow on it. In this text, the symbols f , * , <■ , and * 
designate the Arrow keys. When you see one of these symbols, 
press the appropriate Arrow key. 
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Try moving the cursor around the sheets from field to field with 
the Arrow keys and between the windows with the semicolon. 
The two sheets displayed, the Variable and Rule Sheets, move up 
and down but not right and left. Notice the beep when the cursor 
hits the edge of a sheet. 

When you feel comfortable moving the cursor around the sheets 
and between the windows, move the cursor back to the top of 
each sheet using the colon (:) as a shortcut. 

Start with the cursor in the Variable Sheet and type: 
Move the cursor to the top of the Rule Sheet by typing: 



The screen should again look like Figure 2, but without the Help 
prompt. 

Entering and Solving a One-Equation Model 

You can type information directly onto any of the TK! Solver 
sheets and enter it with ♦ . The following directions show you 
how to enter and solve the model made up of the equation 
a + b = c*d. 

The TKISolver program uses the asterisk (*) as a multiplication 
symbol. To type the multiplication sign (*), the addition sign 
( + ), and the equals sign ( = ), you must hold down a Shift key. 
There are two Shift keys on your keyboard; they are located on 
either side of the bottom row of alphabetic keys and are marked 
SHIFT. 

While you are typing, notice the cue marking your current char- 
acter position within the field. If you make a mistake while typ- 
ing, use < . 

Type: 
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The screen should look like Figure 5. The variable names a, b, c, 
and d appear automatically in the column labeled Name on the 
Variable Sheet. 

( 1 r> Rule: a+b=c*d 



:.= ; = = = = TTr = ;:: = = = T- VARIABLE SHFF.f .- — = —_• = =—" 

Ir.j'jt Name Outfiit Ur. • t ". ■;. t- m t n f 
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Rule 
a+b=c*d 



Figure 5 

The asterisk (*) to the left of the equation indicates that the equa- 
tion has not been satisfied. Using m, move the cursor over the 
asterisk and look at the message at the top of the screen: 

* Unsatisfied 

Now give values to some of the variables. First, move the cursor 
into the Variable Sheet by typing: 



The cursor should be at the top of the column labeled Input and 
beside the variable name a. Type: 



The screen should look like Figure 6. 
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(3i) Input: 10 

==================== VARIABLE SHEET ============= 

j i Irpvi: N.'ime Output Ur.it Comment 



= = = = = = = = = = = = = = = = = = = = R u L E SHEET 

S Rule 



* a+b=c*d 



Figure 6 

Solve the model by holding down the Shift key and typing: 



When the TKISolver program has finished solving, the answer 7 
is displayed next to the variable d in the column labeled Output. 
The screen should look like Figure 7. Notice that the asterisk be- 
side the equation has disappeared now that the equation is satis- 
fied and the model is solved. 

Using the TKISolver program, you have entered and solved a 
model. 
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( 5 i > Input: 10 



= = = = = = = = = = = = = = = = = = = = VARIABLE SHEET ============= 

3 t I n [ i.i t N a m e Output Unit Comment 



50 a 
20 b 
10 c 



RULE SHEET 



S P i . I e 



Figure 7 

Making Changes 

Try changing the input value for b to 100. Move the cursor to the 
Input field next to the variable b and type: 

1 00 ♦ 

To solve for the new value of d, type: 



The new value of d is 15. 

Suppose you want to solve for a instead of d. Move the cursor to 
the Input field for a. Blank out the value by typing: 



Move the cursor to the Input field for d and set a new value by 
typing: 



10 
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The screen should look like Figure 8. 

(4i ) Input : 20 

= = = = = = = = = = = = = = = = = = = = VARIABLE SHEET = = = -- = = = = = .- = = : 

S '. Incut Name Oultut U r, • t O. m T e r, r 





ittilillllilBllfflllSliI 


100 


^^fclix^^IgCa^ 


10 


iSlititiiliiSi|i|iililiigil 


HO 


S&JISSi ; JJ%saS»fc: 



RULE SHEET 



S Rule 

a ♦ b = ■: * d 



Figure 8 

To solve for a, type: 

The output value for a is 100. 

Now try changing the equation to a *b = c+ d. Move the cursor 
into the Rule Sheet by typing: 

Move it into the column labeled Rule with m . 

Instead of retyping the whole equation, you can edit it. Type: 



The cue appears in the field containing the cursor. The Arrow 
keys move the cue within the field. <m and m move the cue left and 
right; t moves the cue to the beginning of the field and * moves 
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it to the end of the information in the field. < deletes the charac- 
ter to the left of the cue. Type: 



The screen should look like Figure 9. 

« 1 r ) R 1 1 'e : a * t; - . * c 



t Inp 


ut 


Nam? 










lllllllllllllillll 


100 




?*>|f^ : -;!v"= 


10 




ISSSSIJftiSSSt 


2 




iiiiitliiiiiiiiii 



VARIABLE SHEET ============= 

Outp',! Ur. t [i.unent 



1 



RULE SHEET 



»:j I. ■:■ 

a*b=c+d 



Figure 9 

Solve the new model by typing 

The output value for a is .3. 
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These instructions have taken you through some of the features 
of the TKISolver program, but the program's real power is its 
ability to solve both simple and elaborate models. The next sec- 
tion uses a simple model to demonstrate this. 

Using Models 

You can create TKISolver models according to your own needs by 
entering sets of equations that express relationships among vari- 
ables. You can also use prepackaged models designed for specific 
applications. 

A simple model, named gravity, has been provided on the 
TKISolver program diskette for this demonstration. To look at it, 
first reset the program by typing: 

/RAY 

The values and comments in the two sheets have now been erased. 
Load the new model by typing: 

/SL 

The prompt asks for a filename. A filename is a name that identi- 
fies a specific collection of information on a diskette. The model 
you are about to use is on the TKISolver program diskette and is 
identified by the filename gravity. 

If you make a mistake while typing the filename, use < to erase 
your error. Enter the filename for the model by typing: 

GRAVITY ♦ 

While the TKISolver program finds the file containing gravity 
and loads it, the red light on the drive may go on and off more 
than once. When the model has been loaded, the screen should 
look like Figure 10. 

Note: In this Guide, a caret ( A ) is used to show exponentiation. 
To type A , hold down the Clear key and type a semicolon (;). The 
Clear key is on the right side of the keyboard and is marked 

CLEAR. 
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1 = = = = ^:= = = = = = = == = = ^ VARIABLE 5HEET = = = = — — = = = = = 

s t I r-i: ij t Name Oj: cut lin • t [jtii»-t 



\ i r f ;■ . ■ r I ■■;, . ■ t / : 

s tine 

f • ..i • ■■. t -J - ': « 

t " / s A 2 a r a •.- -s c ■: s 



RULE SHEET 



Bui? 



v = g* t 

s=. 5*g*t*2 

•j = 9 8 . 6 6 5 "in r. m r- e r >; e c o n ■) -; .] ■ i a '- e "J 



Figure 10 

On the screen are the variables and equations for a simple model 
that determines the final velocity of an object dropped from a 
resting point in a vacuum. 

As you can see, the variable names, units, and equations have 
already been entered. The third equation contains a comment, 
which begins with a quotation mark. The TKISolver program ig- 
nores comments when it solves a model. 

Because g has been set as a constant, all you have to do to solve 
the model is enter one value. 

For example, if the distance of the fall is 300 feet, what are the 
final velocity and time for the fall? 

Move the cursor into the Variable Sheet by typing: 



Move the cursor down to the Input field for s (distance) and type: 

3 ♦ 
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The screen should look like Figure 1 1. 



(3i) Input: 300 

St lnpi.il Name Our out ijr, it Comir.fen'. 



v ft/s velocity 

300 s ft distance 

9 ft /s A 2 grav acce 



RULE SHEET ========= 



S Rule 



* v=g*t 

* s=.5*g*t*2 

I* g = 980.665 " i r. ■: m per le'.-j',: i.]u;ir-.-; 



Figure 11 

To solve the model, type: 

The screen should look like Figure 12. 

The velocity is given in feet per second, expressed as ft/s. Sup- 
pose you are interested in finding what the velocity would be in 
centimeters per second, expressed as cm/s. 

Move the cursor to the Units field for v. Type: 

The value in the Output field is converted to centimeters per sec- 
ond. The screen should look like Figure 13. 

Now change the unit for velocity to inches per second, expressed 
as in/s. Type: 
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(3i) Input: 300 



==================== VARIABLE SHEET ============= 

St I -> p ~J ■ N i me u t [j u t U r . • t i ;, n m •=• r. r 



1 3 8 . 9 1. 2 - f : / s ,- e '. '-■ c i t , 

t 4.3184033 s time 

300 s ft distance 

q 3 / . ' 7 3 9 8 5 r t / - A 2 g • a . a ■: <■ e I 



RULE SHEET 



S Rule 



s=. 5*g*t A 2 

■1 = 98 0.66? " ■ -■ r. m i: e r -,•?.. c •' r: v:iui'»a 



Figure 12 



(1u) Unit: cm/s 

==================== VARIABLE SHFTT ============= 

Sr Input. Nam- Outp'.j' Unit :-.mm-?-t 



v 4234.9069 cm/s velocity 

t 4.3184033 s time 

300 s ft distance 

ci I i . 1 ? ? 9 8 5 1 r .• ■■;, A I <\x ■■>-. a : ■: - I 



■3 = 980.665 "in rn r-er '-.-■: •:■ n j •■ q u i r e i ^^ 

Figure 13 
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The output value again changes, this time to 1667.2829. 

Using the Unit Sheet, you can convert between different units of 
measurement. A unit conversion must be defined on that sheet 
before it can be used by the TKISoIver program. The gravity 
model includes some unit conversions. To look at the Unit Sheet 
for gravity, type: 



Suppose you want to see the velocity in meters per second, ex- 
pressed as m/s. Since that unit does not appear on the Unit Sheet, 
you must define the conversion. 

Using • , move the cursor to the bottom of the column labeled 
From. Type: 



The screen should look like Figure 14. 
Now return to the Variable Sheet by typing: 

Change the unit for velocity to m/s by typing: 



Because you added m/s to the Unit Sheet, the TKISoIver pro- 
gram was able to make the conversion. The value of v is 
42.349069. 

This is the end of the quick introduction to the TKISoIver pro- 
gram. To quit the program, type: 



If you are ready to stop, remove the TKISoIver diskette and put it 
away. Then turn off your computer. 
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UNIT SHEET =========== 

Nuiti i;. ■ . B . A d •:! t f t •:- 1 

; o . 4 8 o o ;, 

2.54 5 

100000 

30.48006 
5 0.48006 
2.540 5 
100 
RULE SHEET =========== 



s= . 5 *g * t *2 

•g - 98 0. 665 "in cm per :*conci '. n J 3 <■ t- :i 



Figure 14 

More Information Afooyt the TKISolwer Program 

This Introductory Guide has demonstrated only a few of the fea- 
tures of the TKISolver program. As you become more familiar 
with the program, you will learn more about these and other fea- 
tures for building models to solve problems and for tailoring 
models to meet your specific needs. 

The TKISolver program includes a Help Facility that is a quick 
reference to features and commands. The Help Facility is only a 
reference; it is not intended to replace the Instruction and Refer- 
ence Manuals. Both the Instruction and Reference Manuals in- 
clude a description of the Help Facility. 

The TKISolver package provides several tools to teach you how 
to use the program: 

• The Instruction Manual provides step-by-step instructions on 
how to use each feature of the program by guiding you through 
a variety of models and helping you learn to build models. 
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• The TK'Solver Program Diskette contains the models used as 
examples in the Instruction Manual. 

• The Reference Manual presents a complete and detailed de- 
scription of each feature of the program with cross-references, 
a glossary, and an index. 

• The Reference Card is a quick reference to the features of the 
TK! Solver program. 

• The Reference Poster graphically displays the TKISolver com- 
mands and sheets and lists the built-in functions. 

Software Arts supports users of its products with the SATN* 
journal. The journal is intended to help users make more effec- 
tive use of Software Arts programs through tips, tutorials, and 
examples of practical applications. 
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